Skip to main content

Supplier Import

Introduction

This will import VISN suppliers for UK and Ireland.

download sample supplier import file.

Fields

Visn Supplier Import

Column PositionHeader NameDescriptionDatatypeValidationMax lengthMandatoryDefault ValueExample
ADI Group IDId of the GroupstringA-Z, 0-9 and all special characters30NoymaA5vcxNWOwzKOdvIMA
BDI Supplier IDId of the SupplierstringA-Z and 0-920NolpEfZekDPAabVoyzcFxM
CERP Garage IDExternal Rate Provider Garage IDNumber0-9-No1900
DERP Garage Group IDExternal Rate Provider Garage Group IDNumber0-9-No768
ELocaleLocale of the supplierstringen_GB(The string should be en_GB for uk supplier) or en_IE(The string should be en_IE for Ireland supplier)-Yesen_GB
FGroup IDGroup ID of the supplierstringA-Z and 0-920YesDIVSN10024
Ghas FNPFNB Availability StatusstringY or N1NoNY
HFNP BandFNP band valueStringBand 1 LA1, Band 2 LA1, Band 3 LA1, Band 5 (M25) LA1, Band 1 LA2, Band 2 LA2, Band 3 LA2, Band 5 (M25) LA2, Band 1 LA3, Band 2 LA3, Band 3 LA3, Band 5 (M25) LA3, NONE20YesBand 1 LA1
ISupplier Group NameGroup Name of the supplierstringA-Z ,0-9 and all special characters50NoBellinger & Sons Vauxhall Wantage
JSupplier IDId of the supplierstringA-Z ,0-920NoAD13HBG
KSupplier NameName of the supplierstringA-Z ,0-9 and all special characters50NoAncaster Dartford Renault
LPaybill

Determines how the suppliers are paid.
1) ViSN Hybrid - Customer's Network and DI Network with Paybill.
VISN - Digital INNK will pay the supplier for this customer
DIRECT - Customer will pay the supplier directly
2) ViSN with DI Network and Paybill- Digital INNK will pay the suppliers
3) External Rate Provider Paybill - External Rate Provider will pay the suppliers

stringVISN or DIRECT-YesVISN
MVAT Registration NumberVAT Registration NumberstringA-Z ,0-920NoVAT1234
NCompany NumberCompany NumberstringA-Z ,0-920NoCMP1234
ONominated Dealer ManagerNominated Dealer ManagerstringA-Z ,0-9, hyphen and space20YesSteve Philips
PAddress 1Building NumberstringA-Z ,0-9 and all special characters20No88
QAddress 2Address 2stringA-Z ,0-9 and all special characters50NoPlaistow Lane
RAddress 3Address 3stringA-Z ,0-9 and all special characters50NoBromley
SAddress 4Address 4stringA-Z ,0-9 and all special characters50NoKent
TAddress 5Address 5stringA-Z ,0-9 and all special characters50NoMiddlesex
UPostcodePostcodestringStandard UK and Ireland postcode validation-YesSE20 7TF
VRegion 1Region 1stringA-Z ,0-9, hyphen and space50NoEvans Halshaw
WRegion 2Region 2stringA-Z ,0-9, hyphen and space50NoEast Sussex
XRegion 3Region 3stringA-Z ,0-9, hyphen and space50NoBrightonCCC
YPrimary Phone NumberPrimary Phone NumberstringA-Z ,0-9 and all special characters20Yes02082 908700
ZBooking Phone NumberBooking Phone NumberstringA-Z ,0-9 and all special characters20No02082 908700
AAFax NumberFax NumberstringA-Z ,0-9 and all special characters20No02087 689200
ABemailemail of the supplierstringA-Z ,0-9 and all special characters100Novishwa@digitalinnk.com
ACdescriptiondescriptionstringA-Z ,0-9 and all special characters50Nosupplier from Chelmsford
ADnotesnotesstringA-Z ,0-9 and all special characters20NoNotes
AEMax HeightMax HeightstringA-Z ,0-9,underscore,hyphen and plus sign20No+123
AFMax LengthMax LengthstringA-Z ,0-9,underscore,hyphen and plus sign20No-58
AGMax WeightMax WeightstringA-Z ,0-9,underscore,hyphen and plus sign20No77
AHLast Physical AuditLast Physical Audit-No Validation available for this field-No-
AILast Desktop AuditLast Desktop Audit-No Validation available for this field-No-
AJCollection DelCollection DelstringY or N1NoNY
AKCollection NTDCollection NTDstringY or N1NoNY
ALCollection Lead TimeCollection Lead TimeNumber0-92No44
AMCollection RadiusCollection RadiusNumber0-92No22
ANCollection NotesCollection NotesstringA-Z ,0-9 and all special characters30NoCollection Notes
AOCourtesy CarCourtesy CarstringY or N1NoY
APCourtesy Car NtdCourtesy Car NtdstringY or N1NoNY
AQCourtesy Car Lead TimeCourtesy Car Lead TimeNumber0-92No22
ARCourtesy Car NotesCourtesy Car NotesstringA-Z ,0-9 and all special characters30NoNotes about courtesy car service
ASWhile You WaitWhile You WaitstringY or N1NoNY
ATWhile You Wait NTDWhile You Wait NTDstringY or N1NoNY
AUWhile You Wait Lead TimeWhile You Wait Lead TimeNumber0-92No22
AVWhile You Wait NotesWhile You Wait NotesstringA-Z ,0-9 and all special characters30NoNotes about while you wait service
AWDrop OffDrop OffstringY or N1NoNY
AXDrop Off NTDDrop Off NTDstringY or N1NoNY
AYDrop Off Lead TimeDrop Off Lead TimeNumber0-92No43
AZOut Of HoursOut Of HoursstringY or N1NoNY
BAMobileMobilestringY or N1NoNY
BBMobile Lead TimeMobile Off Lead TimeNumber0-92No43
BCMobile RadiusMobile RadiusNumber0-93No43
BDFranchiseFranchisestringA-Z ,0-9 and all special characters30YesAll
BEIndependentIndependentstringY or N1NoNY
BFIs On ViSNIs On ViSNstringY or N1NoNY
BGBosch StatusBosch StatusstringA-Z ,0-98No-
BHNetworkNetworkstringA-Z ,0-98No-
BINetwork LevelNetwork LevelstringA-Z ,0-98No-
BJLabour CarLabour Carstring0-9 and .(decimal number)6No4.5
BKLabour Rate LCVLabour Rate LCVstring0-9 and .(decimal number)6No4.5
BLLabour Rate EVLabour Rate EVstring0-9 and .(decimal number)6No4.5
BMParts DiscountParts Discountstring0-9 and .(decimal number)5No94.5
BNMOT Class1MOT Class1string0-9, .(three digit decimal number)6No941.5
BOMOT Class2MOT Class2string0-9, .(three digit decimal number)6No941.5
BPMOT Class3MOT Class3string0-9, .(three digit decimal number)6No941.5
BQMOT Class4MOT Class4string0-9, .(three digit decimal number)6No941.5
BRMOT Class4aMOT Class4astring0-9, .(three digit decimal number)6No941.5
BSMOT Class5MOT Class5string0-9, .(three digit decimal number)6No941.5
BTMOT Class5aMOT Class5astring0-9, .(three digit decimal number)6No941.5
BUMOT Class7MOT Class7string0-9, .(three digit decimal number)6No941.5
BVSemi Synthetic1Semi Synthetic1string0-9 and .(decimal number)6No4.5
BWSemi Synthetic2Semi Synthetic2string0-9 and .(decimal number)6No4.5
BXSynthetic1Synthetic1string0-9 and .(decimal number)6No4.5
BYSynthetic2Synthetic2string0-9 and .(decimal number)6No4.5
BZSynthetic3Synthetic3string0-9 and .(decimal number)6No4.5
CAAd BlueAd Bluestring0-9 and .(decimal number)6No4.5
CBBrake FluidBrake Fluidstring0-9 and .(decimal number)6No4.5
CCAir Conditioning CoolantAir Conditioning Coolantstring0-9 and .(decimal number)6No4.5
CDAnti FreezeAnti Freezestring0-9 and .(decimal number)6No4.5
CEAutomatic Transmission FluidAutomatic Transmission Fluidstring0-9 and .(decimal number)6No4.5
CFAxle OilAxle Oilstring0-9 and .(decimal number)6No4.5
CGGearbox Oil MineralGearbox Oil Mineralstring0-9 and .(decimal number)6No4.5
CHGearbox Oil SyntheticGearbox Oil Syntheticstring0-9 and .(decimal number)6No4.5
CIHydraulic FluidHydraulic Fluidstring0-9 and .(decimal number)6No4.5
CJLong Life OilLong Life Oilstring0-9 and .(decimal number)6No4.5
CKMineral OilMineral Oilstring0-9 and .(decimal number)6No4.5
CLOther FluidOther Fluidstring0-9 and .(decimal number)6No4.5
CMPower Steering FluidPower Steering Fluidstring0-9 and .(decimal number)6No4.5
CNRefrigerator CoolantRefrigerator Coolantstring0-9 and .(decimal number)6No4.5
COSuspension FluidSuspension Fluidstring0-9 and .(decimal number)6No4.5
CPMerchant FeeMerchant FeestringNo validation present-No-
CQAccount System ReferenceAccount System ReferencestringA-Z,0-98NoABC123
CRService And Maintenance RepairService And Maintenance RepairstringY or N1NoNY
CSAccident Management Body ShopAccident Management Body ShopstringY or N1NoNY
CTTyresTyresstringY or N1NoNY
CUGlassGlassstringY or N1NoNY
CVMOTMOTstringY or N1NoNY
CWBreakdownBreakdownstringY or N1NoNY
CXCarCarstringY or N1NoNY
CYCommercial Under 3_5 tonneCommercial Under 3_5 tonnestringY or N1NoNY
CZCommercial Over 3_5 tonneCommercial Over 3_5 tonnestringY or N1NoNY
DAHGVHGVstringY or N1NoNY
DBMotorBikesMotorBikesstringY or N1NoNY
DCElectric vehicles CarElectric vehicles CarstringY or N1NoNY
DDElectric vehicles LCVElectric vehicles LCVstringY or N1NoNY
DETrailerTrailerstringY or N1NoNY
DFFridgeFridgestringY or N1NoNY
DGCraneCranestringY or N1NoNY
DHWash and VacWash and VacstringY or N1NoNY
DIValetValetstringY or N1NoNY
DJComplimentary RefreshmentsComplimentary RefreshmentsstringY or N1NoNY
DKWiFiWifistringY or N1NoNY
DLParkingParkingstringY or N1NoNY
DMDisposal ChargesDisposal ChargesstringDecimal Number(format should be 00.00)-No99.47
DNValveValvestringDecimal Number(format should be 00.00)-No99.47
DOWheel BalanceWheel BalancestringDecimal Number(format should be 00.00)-No99.47
DPServing ProximityServing Proximitystringshould be a number between '0' and '999' (if serving proximity is not added, then 50 miles will be used as default)3No955
DQWheel Alignment2Wheel Alignment2stringDecimal Number(format should be 00.00)-No99.47
DRWheel Alignment4Wheel Alignment4stringDecimal Number(format should be 00.00)-No99.47
DSRebate AmountRebate AmountstringDecimal Number(format should be 00.00)-No99.47
DTRebate PercentageRebate PercentagestringDecimal Number(format should be 00.00)-No99.47

Importing a file

Preparation

  1. Create a new branch with Jira task number in the branch name

  2. Delete all the files within the importFiles folder to prevent accidental import of incorrect files

  3. Create a folder with the current sprint number

  4. Copy the file that needs to be imported

  5. Go to package.json , find the line validate:suppliers

  6. Modify --leaseId with the required lease Id

  7. Modify --file with the relative path of the file

  8. Modify --leaseCompanyName as per the lease Id

  9. Modify --locale to en_GB or en_IE. Locale will be en_GB by default

  10. Save the package.json

Validating locally

  1. in a terminal run npm run build

  2. in a terminal run npm run validate:suppliers

  3. If there are no errors, push the code

Validating in workflow

  1. Go to Action of Import-manger

  2. Find <Environment> - on-demand-import

  3. Select the branch that was created for this import

  4. Enter script name as validate:suppliers

  5. Leave Overrides empty or you can specify --leaseId, --leaseCompanyName or --locale if required

Importing the file

  1. If the validation has passed

  2. Go to Action of Import-manger

  3. Find <Environment> - on-demand-import

  4. Select the branch that was created for this import

  5. Enter script name as validate:suppliers

  6. Enter --persist in Overrides field

Importing the file via url(using postman and cloud run)

  1. we can also import the file using cloud run. Go to import manager and run action DEV - deploy to cloud run with the latest branch.

  2. Go to cloud run(google cloud console) and select import-manager from the services list.

  3. Copy the url https://import-manager-36r2bu4izq-uc.a.run.app (This might vary for different environments)

  4. Go to postman and paste this url in a post request. Then add the necessary parameters in Body->formData. Please refer image below for parameters to pass.

  5. Upload the file in cloud storage(google cloud console) in the path imports/fileDrop/. Press the upload button to choose the file to import

  1. After uploading run the request using postman. Set the persist parameter to false to validate the file and set it as true to import the file from cloud storage

Testing

  1. Suppliers will be created under the specified group Id. This can be checked in the list of suppliers which belong to the group in DI Admin
Status: Pending Approval
Category: Protected
Authored By: Vignesh Kanthimathinathan on May 31, 2023
Revisions
04 Jan, 2024 - Revise to add FNP band and has FNP, VN-10825